<!DOCTYPE html>
<html>
    <head>
        <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
        <title>Upgrade iRedMail from 1.6.3 to 1.6.4</title>
        <link rel="stylesheet" type="text/css" href="./css/markdown.css" />
    </head>
    <body>

    <div id="navigation">
    <a href="https://www.iredmail.org" target="_blank">
        <img alt="iRedMail web site"
             src="./images/logo-iredmail.png"
             style="vertical-align: middle; height: 30px;"
             />&nbsp;
        <span>iRedMail</span>
    </a>
    &nbsp;&nbsp;//&nbsp;&nbsp;<a href="./index.html">Document Index</a></div><div class="admonition note">
<p class="admonition-title">This tutorial is available in other languages. <a href="https://github.com/iredmail/docs">Help translate more</a></p>
<p><a href="./upgrade.iredmail.1.6.3-1.6.4-nl_DU.html">Nederlands</a> /</p>
</div>
<h1 id="upgrade-iredmail-from-163-to-164">Upgrade iRedMail from 1.6.3 to 1.6.4</h1>
<div class="admonition attention">
<p class="admonition-title">Attention</p>
<p>Check out the on-premises, lightweight email archiving software developed by iRedMail team: <a href="https://spiderd.io/">Spider Email Archiver</a>.</p>
</div>
<div class="toc">
<ul>
<li><a href="#upgrade-iredmail-from-163-to-164">Upgrade iRedMail from 1.6.3 to 1.6.4</a><ul>
<li><a href="#changelog">ChangeLog</a></li>
<li><a href="#general-all-backends-should-apply-these-changes">General (All backends should apply these changes)</a><ul>
<li><a href="#update-etciredmail-release-with-new-iredmail-version-number">Update /etc/iredmail-release with new iRedMail version number</a></li>
<li><a href="#required-centos-stream-rocky-almalinux-8-switch-to-php-v80">[REQUIRED] CentOS Stream / Rocky / AlmaLinux 8: Switch to PHP v8.0</a></li>
<li><a href="#fix-incorrect-ssl-ca-file-and-idn-support-in-postfix">Fix incorrect ssl CA file and IDN support in Postfix</a></li>
<li><a href="#upgrade-iredapd-postfix-policy-server-to-the-latest-stable-release-533">Upgrade iRedAPD (Postfix policy server) to the latest stable release (5.3.3)</a></li>
<li><a href="#upgrade-netdata-to-the-latest-stable-release-1410">Upgrade netdata to the latest stable release (1.41.0)</a></li>
<li><a href="#upgrade-roundcube-webmail-to-the-latest-stable-release-162">Upgrade Roundcube webmail to the latest stable release (1.6.2)</a></li>
</ul>
</li>
</ul>
</li>
</ul>
</div>
<div class="admonition note">
<p class="admonition-title">Remote Upgrade Assistance</p>
<p>Check out our <a href="https://www.iredmail.org/support.html">remote upgrade support</a> if you need assistance.</p>
</div>
<h2 id="changelog">ChangeLog</h2>
<ul>
<li>Jul 28, 2023: initial publish.</li>
</ul>
<h2 id="general-all-backends-should-apply-these-changes">General (All backends should apply these changes)</h2>
<h3 id="update-etciredmail-release-with-new-iredmail-version-number">Update <code>/etc/iredmail-release</code> with new iRedMail version number</h3>
<p>iRedMail stores the release version in <code>/etc/iredmail-release</code> after
installation, it's recommended to update this file after you upgraded iRedMail,
so that you can know which version of iRedMail you're running. For example:</p>
<pre><code>1.6.4
</code></pre>
<h3 id="required-centos-stream-rocky-almalinux-8-switch-to-php-v80">[REQUIRED] CentOS Stream / Rocky / AlmaLinux 8: Switch to PHP v8.0</h3>
<p>CentOS / Rocky / AlmaLinux 8 offers php v8.0 in official yum repository, you
can switch to php v8.0 if you want by following this short tutorial, so that
you can upgrade Roundcube to latest v1.6.2.</p>
<ul>
<li><a href="./upgrade.php.v8.0.on.centos.8.html">Upgrade php to 8.0 on CentOS Stream / Rocky / AlmaLinux 8</a></li>
</ul>
<h3 id="fix-incorrect-ssl-ca-file-and-idn-support-in-postfix">Fix incorrect ssl CA file and IDN support in Postfix</h3>
<p>Run shell commands below as root user to fix incorrect ssl ca file, also
disable IDN support.</p>
<ul>
<li>On RHEL/CentOS/Rocky/AlmaLinux:</li>
</ul>
<pre><code>postconf -e smtp_tls_CAfile='/etc/pki/tls/certs/ca-bundle.crt'
postconf -e smtpd_tls_CAfile='/etc/pki/tls/certs/ca-bundle.crt'
postconf -e smtputf8_enable=no
postfix reload
</code></pre>
<ul>
<li>On Debian and Ubuntu:</li>
</ul>
<pre><code>postconf -e smtp_tls_CAfile='/etc/ssl/certs/ca-certificates.crt'
postconf -e smtpd_tls_CAfile='/etc/ssl/certs/ca-certificates.crt'
postconf -e smtputf8_enable=no
postfix reload
</code></pre>
<ul>
<li>On FreeBSD and OpenBSD:</li>
</ul>
<pre><code>postconf -e smtp_tls_CAfile='/etc/ssl/cert.pem'
postconf -e smtpd_tls_CAfile='/etc/ssl/cert.pem'
postconf -e smtputf8_enable=no
postfix reload
</code></pre>
<h3 id="upgrade-iredapd-postfix-policy-server-to-the-latest-stable-release-533">Upgrade iRedAPD (Postfix policy server) to the latest stable release (5.3.3)</h3>
<p>Please follow below tutorial to upgrade iRedAPD to the latest stable release:
<a href="./upgrade.iredapd.html">Upgrade iRedAPD to the latest stable release</a></p>
<h3 id="upgrade-netdata-to-the-latest-stable-release-1410">Upgrade netdata to the latest stable release (1.41.0)</h3>
<p>If you have netdata installed, you can upgrade it by following this tutorial:
<a href="./upgrade.netdata.html">Upgrade netdata</a>.</p>
<h3 id="upgrade-roundcube-webmail-to-the-latest-stable-release-162">Upgrade Roundcube webmail to the latest stable release (1.6.2)</h3>
<div class="admonition warning">
<p class="admonition-title">CentOS 7: please stick to Roundcube 1.5.2</p>
<p>If you're running CentOS 7, please upgrade to Roundcube 1.5.2 instead.
Roundcube 1.5.3 requires PHP-7, but CentOS 7 ships PHP-5.4 which is not
supported by Roundcube 1.5.3 (and the latest 1.6.0).</p>
<p>It's time to leave your comfort zone and upgrade this server to at least
CentOS Stream 8 or <a href="https://docs.rockylinux.org/guides/migrate2rocky/">Rocky Linux 8</a>.</p>
</div>
<p>Please follow Roundcube official tutorial to upgrade Roundcube webmail to the
latest stable release:</p>
<ul>
<li><a href="https://github.com/roundcube/roundcubemail/wiki/Upgrade">How to upgrade Roundcube</a>.</li>
</ul><div class="footer">
    <p style="text-align: center; color: grey;">All documents are available in <a href="https://github.com/iredmail/docs/">GitHub repository</a>, and published under <a href="http://creativecommons.org/licenses/by-nd/3.0/us/" target="_blank">Creative Commons</a> license. You can <a href="https://github.com/iredmail/docs/archive/master.zip">download the latest version</a> for offline reading. If you found something wrong, please do <a href="https://www.iredmail.org/contact.html">contact us</a> to fix it.</p>
</div></body></html>